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GETTING STARTED X 


he way we communicate is a moving target. Mediums are ever-changing, our vocabulary 

always evolving. Technology, fads, and social movements are constantly reshaping how we 

communicate with our peers, our families, and our colleagues. These shifts easily lead us to 
believe that learning communication strategies is a fruitless pursuit. Why learn something that will 
be outdated before you ever get a chance to apply it? 


This is a valid concern for anyone putting time into learning a new skill. While the mediums and 
language trends may change, the essentials of effective communication are timeless. By focus- 
ing your energy and attention on learning the foundational elements of communication, you can 
become an effective communicator regardless of the time and place in which you find yourself. 


EVERYONE IS DOING IT 


It is easy to believe that because communicating is something we all do—most of us from an early 
age—that getting better at it is a waste of time. If 1 learn to walk when Iam 18 months old, why put 
time into becoming better at walking when I am 18, 28, or 58 years old? 


Studies have shown that improving your walking technique, frequency, and speed can benefit car- 
diovascular health and overall well-being. In addition, doctors often look to walking strides and 
speeds as an indication of health in older adults. Spending time becoming better at walking has 
positive, tangible outcomes, and it is something you have been doing since before you could talk. 


Vii 


No matter the skill, there is always a benefit to taking the time to improve upon it. This is most often 
true with skills that we take for granted, such as writing or speaking (or walking). Because most 
people engage in these activities every day, we greatly overestimate our ability to do it well. 


Some concrete ways in which becoming a better communicator will benefit you in the near and long 
term are as follows. 


¢ Improved outcomes on assigned tasks or projects 

¢ Higher quality responses to email outreach 

¢ Healthier interpersonal relationships 

« Stronger resumes and cover letters that help you stand out in a crowd 
¢ Greater credibility and authority in the workplace 

¢ Better clarity of thought and improved ability to think deeply 

¢ Refined organization skills and greater ability to focus 

¢ Broaden overall depth of knowledge and vocabulary 


This book explores some of these benefits in greater depth in the following chapters, but the early 
takeaway is that being a better writer is not just an academic pursuit or something people do if they 
want to be a novelist. The benefits are far-reaching and apply not only to your chosen career path 
but also to your personal life. 


CLARITY OF THOUGHT 


A section of this book is dedicated to using writing as a mechanism for thinking. While our tech- 
nological advances have made improvements to our quality of life, they have also created a world 
that moves very fast. Being able to think effectively about a topic, problem, or decision has become 
increasingly difficult because of the quick pace of everyday life and all of the noise that creeps in 
from the outside. 


Critical thinking has become a lost component of quality communication because in the “always-on” 
environment we live in, being a good communicator is sometimes measured by how rapidly some- 
one responds. As noted by Jay Huffman (2020) in a piece on why companies often overlook the val- 
ue of good writing, “this isa dangerous way of thinking because it doesn’t give you time to formulate 
your thoughts and give a meaningful response.” 


Vili Technical Communication Essentials 


Beyond the critical thinking section, this book covers why it is important to build your timelines in 
a way that allows for time away from what you are working on and why it is important to review and 
revise everything, even emails. The time away and revise everything concepts lend themselves well 
to providing the time and space necessary to gain clarity, which enables you to provide a valuable 
deliverable for your audience. We will dig into strategies and tools that can help build that space 
naturally in your workflows. 


EFFICIENT + EFFECTIVE 


Throughout this book, you will see the terms “efficient” and “effective” used frequently, often togeth- 
er. Since you will see them often, let us take a moment to define them. 


When we talk about being efficient with our communication, we are referring to the amount of en- 
ergy and effort we put into something as it relates to the output of said energy and effort. In practice, 
being efficient is demonstrated by having a process and method that reduces the amount of work 
necessary to produce a high-quality outcome. 


For example, if you often create presentations that report on your quarterly business initiatives, then 
creating a process that enables you to replicate your report with minimal additional effort (beyond 
creating the process itself) makes your reporting efforts efficient. Minimum effective input with 
replicable, high-quality output. 


Note how this example of efficiency in the workplace includes a mention of effectiveness. While 
effectiveness is a similar concept, it is differentiated by its focus on impact and outcomes. 


Effectiveness is measured by achieving a desired outcome. The importance in differentiating the 
two, and why we often see these terms used together, is that a process could be efficient, minimum 
input to produce an output, but if it does not achieve the desired outcome or quality standards, then 
the efficiency of the process is meaningless. 


In the above reporting example, ensuring an efficient and effective process would make the process 
replicable and require a certain minimum threshold of input, but it would put in as much effort as is 
necessary to ensure that the report adds value to the business. If it does not add value, then it does 
not matter how efficient the process was to get you there. 


The strategies in this book provide the foundational skills necessary to be both efficient and effec- 
tive; the ultimate achievement in technical communication. 
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WHAT IS NEXT? 


This book is divided into three sections: 


1. Write to Think 
2. Build the Foundation 
3. Document and Deliver 


Write to Think is primarily concerned with explaining how and why critical thinking is an import- 
ant component of technical communication and how you can integrate critical thinking strategies 
into your daily communication efforts. 


Build the Foundation is all about the tactical elements of technical communication. This is the nuts 
and bolts of what constitutes efficient and effective writing and provides tangible tools you can use 
in your own writing. 


Document and Deliver explores all of the potential outputs of good technical communication. 
From reports and emails to presentations and help documentation, this section shows all of the 
foundational strategies at work in clear, value-add deliverables. 
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SECTION 1 fi 
WRITE TO THINK 


CHAPTER 1 
First Principles 


riting about technical topics can get complicated quickly. Not only is the subject matter 

complex, but the act of writing is one that can be tough to navigate. Though the subject 

area or industry you are writing about will vary, the writing process is one that can 
be made less complex by breaking it down into its most basic components. This is first-principles 
thinking. 


When applied to writing, especially technical or business writing, first principles allow for a more 
efficient writing process as well as expedited understanding from the audience. The more efficiently 
you write, the more time you will have to focus on the subject matter. In addition, as you work to 
be more efficient and effective with your writing, your audience will be able to consume and under- 
stand the information you are delivering with greater speed and ease. 


Before we introduce the fundamentals of writing strategies, sketching out first principles associated 
with writing can give you a foundation of practical knowledge that will make applying the more 
specific writing strategies easier. 


WHAT ARE FIRST PRINCIPLES? 


A core concept of technical communication is removing assumptions as a way to provide clarity and 
directness for your audience. First principles works similarly. At its most foundational level, first 
principles is an effort to strip away everything until only the essential remains, where there are no 
assumptions or conventions necessary for understanding. 


A good analog for understanding first principles in action is to look at the difference between a 
chef and a cook. A chef is someone who creates the recipes. They understand the ingredients and 
how they can be combined and complementary in new and interesting ways. On the other hand, a 
cook is someone who can take the recipe and replicate the dish. They do not have to have the same 
understanding of the ingredients in order to do their job, but they may have a harder time creating 
new dishes from scratch. 


FIRST PRINCIPLES OF WRITING 


There are several first principles of writing that can be mapped back to use in technical communication. 


AUDIENCE 


Before you can write or create any piece of communication, you must know who are you are writing 
it for. A creative writer or an artist might create something for the sake of the art that serves the 
artist more than it serves the consumer. If the consumer finds value it in, then that is a bonus. For 
a technical communicator, the audience must be specific and at the center of the communication. 
Focusing on any other part of the writing process prior to determining who your audience is will 
derail you in the long term. 


POINT OF VIEW 


In technical writing, your point of view determines how you will connect with your audience. Hav- 
ing identified an audience, you can then begin to unwrap how you will get the information to them 
in a seamless and natural way. Understanding your audiences’ needs, wants, and behaviors will al- 
low you to break down the best way to write and organize your content for maximum effectiveness. 


PURPOSE 


Much like the plot in creative writing, the purpose in technical writing provides the map for the 
audience. You now know who they are and how to reach them, so where will you take them? The 
purpose guides the audiences’ journey. Once you have a purpose for the communication, you can 
lay the approach you will use to get the audience to take action. The purpose includes the context 
your audience needs to take action, provides support and data, and fills in any gaps in knowledge 
that may exist. 
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ACTION 


All technical communication has an associated action. This is a key differentiator from other types 
of communication and is essential for creating effective materials. What do you want your audience 
to do with the information you have presented? From a first-principles perspective, you can begin 
with an action and work backward through the rest, but without action, you will be missing a key 
element of technical communication. 


Though we dive into each of these principles in more detail throughout this book, having a high- 
level view early on can make writing feel less daunting. Rather than just improve your writing for a 
single course or project, getting a feel for the first principles will make it easier for you to carry these 
lessons with you throughout your career. 
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First Principles 5 


The practice of distilling your writing down to first principles requires critical thinking and thought- 
fulness with regard to the way you present information to your audience. Rather than follow a list of 
requirements or prepackaged ideas, starting from first principles can put you more squarely in the 
chef category, where you bring your own ideas to the table in order to accelerate the understanding 
of your audience. 


Any time you are feeling overwhelmed or unsure of where to begin, go back to these first principles 
and you will be set up for a successful outcome. 


A NOTE ABOUT SUCCESS 


Several times throughout this book you will see references to being set up for success or creating 
successful communication materials. In the context of technical communication, success refers to 
how likely it is that your audience will take the desired action. If your document, presentation, or 
any other communication method leads your audience to take the action you specify within, then 
you have done your job successfully. 
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CHAPTER 2 
Map Versus Territory 


lfred Korzybski, a scholar of semantics (the meaning of words), coined the phrase “the map 
is not the territory” in the 1930s as a way to explain how we often see things as a represen- 
tation of reality (via maps or pictures in our head) versus reality itself. 


Although the semantic argument itself is complex, the way it shows up in our daily life is how it 
allows the map to shape our reality rather than letting our reality shape the map. 


AVOIDING THE PITFALLS OF STRUCTURE 


If you owned a GPS before a smartphone, then you know those maps were often imperfect illustra- 
tions of the actual route you were on. If you failed to update your GPS routinely, you could easily 
end up driving on roads that were not yet depicted on the map, and even more easily, getting lost. 


This same situation occurs when you set out to create a structure for your content and attempt to 
follow it exactly from start to finish. The reality is that as you write, your main points change, new 
information is uncovered, and additional areas of focus emerge. 


When you use the road map (your draft or outline), as written without the flexibility of shifting 
things as the need arises, you end up with a deliverable that has either too much information, not 
enough information, or the wrong kind of information the audience needs in order to take action. 
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Making revisions to the road map allows space for natural changes that happen over time and en- 
ables you to accommodate shifting perspectives and needs for your audience. Moreover, when you 
make an effort to identify new roads and opportunities, you will uncover better ways to get from 
point A to point B faster and with fewer wrong turns, which is ultimately the goal of a map. 


Having structure in your writing is important, but the structure should not be walls that you build 
for yourself as you write. In fact, having the structure is what will allow you to be flexible along the 
way because you know that you can always course correct back to the planned route if needed. 


DRAWING THE MAP 


Although many best practices and strategies exist for technical communicators, many of which we 
cover later in this book, you should question how and why these strategies are used. The concept of 
the map versus the territory can also be applied to better understanding the reason why certain best 
practices and strategies exist. 
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Remember, in order to be a good chef, you have to thoroughly understand the ingredients and the 
techniques necessary to bring out the best in those ingredients. The same is true for a good technical 
communicator. Rather than just being a writer, being a strong communicator means that you have 
a thorough understanding of the underlying concepts that make for efficient and effective content. 


When evaluating best practices and strategies, think about the following considerations: 


REALITY IS THE BEST LEVEL-SET. 


You can best ensure that you are not just following a predetermined path by taking a step back and 
looking at the reality of your particular project. Your audience is composed of real people. The prob- 
lems you are trying to solve are real. The best practices you have been taught may represent the ideal 
better than reality, so do not be afraid to gut-check the strategies you are using against the reality of 
the situation. If they still apply, you can deploy them and move on. But if there is a clear gap in what 
is laid out before you and the real situation at hand, do not hesitate to change things up. 


CONSIDER THE CREATOR. 


Who developed the strategies you plan to use? In what context did they do so? If you do a little dig- 
ging into the origin of certain concepts, you will often find that they were developed out of scenarios 
that are much different than those you are currently trying to solve for. It may be that you can find 
strategies that better align with your audience and purpose or you can adjust the strategy in ques- 
tion to better fit your current scenario. 


EXISTING STRATEGIES CAN INFLUENCE NEW ONES. 


As best practices and strategies are developed, they greatly influence those that come after it, as they 
were influenced by those that came before it. Truly original ideas are hard to come by, so you should 
always consider the strategies that had an impact on the ones you are using to connect with your 
audience. Looking at the evolution of technical communication and how we think about commu- 
nicating with audiences can illustrate the biases and assumptions that may be at work within the 
existing best practices and strategies used in the field. 
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IN PRACTICE 


It is easy to overlook this section as a philosophical exercise that is nice for people who have a lot of 
time on their hands or who do not have to work under pressing timelines or requirements. However, 
taking a critical approach to your writing and the methods you use will help improve your own 
communication style and create a shift in the way your organization communicates. The outcomes 
of this type of mental work can be tangible in how your organization approaches internal and exter- 
nal communication and are essential for ensuring your organization evolves with regard to equity, 
globalization, and diversity in the workplace and marketplace. 
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CHAPTER 3 
Perspective Shift 


hifting your perspective is a powerful tool to have on hand when evaluating whether or not 

your final product aligns with what you set out to do initially. Looking at what you have cre- 

ated from a different angle or with different assumptions strengthens a strong deliverable and 
shines light on areas of opportunity for a deliverable that could be improved. 


There are several methods for shifting your perspective, and no one way is the right way. The meth- 
od through which you shift your perspective is less important than the shift itself. When used in 
conjunction with the revision and editing techniques outlined later in the book, you will have a full 
set of tools with which to stress test your deliverables and ensure they are ready for your audience. 


INVERSION 


Inversion, as is clear in the name, is a way of inverting your thinking so that you flip your original 
ideas and output on its head to make sure they still hold up. This means, once you flip it around, is 
it still valuable for your audience? Does it move them toward action? 


One way to think about inversion is by trying to prove your own work. If you take the action or 
outcome and assume that it is true, then what else needs to be true? What other elements need to 
be present in order for your action to still make sense? Working backward in this way can help you 
check boxes of what is included in your deliverable. If there are specific elements that should exist 
for the action to be accurate, but they are missing, then this is an opportunity to add them in and 
provide clarity for your audience. 


Another way to practice inversion is to remove the outcome or action, think deeply about what 
action you want to avoid, and then see if the rest of the document could be interpreted in a way that 
leads to the undesired outcome. 


In this method, you are stress testing your deliverable to ensure that your audience could not come 
to a false or undesired conclusion. While the action is a key component of the document, it should 
not have to stand alone as the only indication of what you want your audience to do. The deliver- 
able’s content should lead up to the action in a clear and logical way. If your content could be inter- 
preted differently, then this is an opportunity to add clarity and direction. 


One of the easiest ways to shift your perspective is to put yourself in the role of your primary or 
secondary audience or both. Taking the perspective of your audience provides an opportunity to 
ensure that your deliverable will have the desired outcome you are aiming for. 
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Later in the book, we explore audience analysis and how you can craft a portrait of your real audi- 
ence prior to the research and writing process. You can use the audience analysis to get into charac- 
ter. Put yourself in your audience's shoes and either read or present your deliverable to yourself or 
get someone to do it for you. 


Does the action make sense given the content and context? Were there any gaps in the deliverable 
that might be confusing or misleading? Seeing your work from an outsider’s perspective is an ex- 
ercise that can provide ample opportunity for revisions that will strengthen your deliverable and 
ensure your audience is not left with more questions than answers. 


SECOND-ORDER THINKING 


Complex in name, simple in execution, second-order thinking is the intentional exercise of outlin- 
ing potential unintended consequences or takeaways from your content. 


A good example of unintended consequences is looking at the impact of seat belt laws in the United 
States. While seat belt laws were enacted to keep passengers of motor vehicles safe, it was thought 
that they could result in more crashes (though, less fatal) due to drivers feeling safer and engaging 
in reckless driving behavior. Even though there is no empirical proof that this is true, it does provide 
a lens through which you can understand second-order thinking and how there is always more at 
stake than just the topic at hand. 


Looking at this concept in technical communication, examples are prevalent. Consider a memo that 
goes out to employees about not parking in a specific lot due to resurfacing efforts (an example we 
look at in more detail later in the book). The intended consequence is that employees do not park 
on a freshly resurfaced lot or get in the way of those efforts. However, an unintended consequence 
could be that more employees park on the street and have their cars towed because it is a no parking 
zone. 


Thinking about downstream consequences of your deliverable is essential for ensuring that your 
solution or recommendations do not cause additional problems. Some of these issues may be un- 
avoidable, but if you can identify them then, you can take measures to mitigate them later. 


A simple reread and 5-minute brainstorm of other ways the action could have an impact will allow 
you to catch any glaring red flags or problem areas and can lead to identifying other areas of oppor- 
tunity for adding clarity to your deliverable. 
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Depending on your industry or area of expertise, this type of downstream exercise may be part of 
the regulatory standards to provide an extra layer of safety for your audience. 


INTEGRATING PERSPECTIVE SHIFTS INTO YOUR PROCESS 


Regardless of the method you use to shift your perspective, you should integrate this practice into 
your writing process. Not only will it ensure that your deliverable aligns with your intended purpose, 
it will expand your view of what your work is and could be given different scenarios or perspectives. 


Practically, this exercise should be implemented toward the end of your writing process but prior 
to the editing and revision stage, or as a component of that work. Your writing will be stronger and 
your deliverable more effective. 


14 Technical Communication Essentials 


CHAPTER 4 
Simplicity 


n technical communication, complex topics are presented in a simple, easy-to-understand way 
that ensures an audience has the information they need to engage safely and appropriately with 
technology. 


Professionals and experts sometimes fall into the trap of believing that more is better. The more 
information you can provide, the better chance you will have of your audience taking the desired 
action. When we get into the mode of being additive because we think it will add credibility or au- 
thority, it creates unnecessary complexity that the audience then has to unwind in order to get to 
the action. 


Approaching your content creation from a place of simplicity can enable a more concise, relevant, 
and actionable outcome that your audience will appreciate. 


There are frameworks and theories available that provide a baseline for understanding simplicity 
and how it can be implemented in technical communication deliverables. 


OCCAM’S RAZOR 


The framework of Occam’s Razor provides a way for us to look at simplicity in more practical terms. 
Essentially, Occam’s Razor is the theory that the simplest explanation is preferable to one that is 
more complex. Generally used within scientific studies, this theory can also be applied to technical 


content. 


Much like first-principles thinking, Occam’s Razor insists that methods and ideas should be broken 
down to their most essential components before adding layers of explanation and detail. 


One interesting exercise that uses this framework is to take what you have written and then rewrite 
it as the following: 


¢ Five paragraphs/slides 
e Five sentences 
e Five words 


Though you likely will not end up only using five words for your deliverable, this exercise can help 
you get a better handle on what is essential and create thresholds for how simply you can present 
your information. 
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PARETO PRINCIPLE 


The Pareto Principle, more commonly known as the 80/20 rule, is another framework that has a 
bias toward simplicity. The Pareto Principle states that 80% of an outcome is produced by 20% of the 
inputs. This means, the most important components of your communication (20%) will illicit action 
(80%) on the part of the audience. 


Imagine for a moment that you work at a startup that is trying to secure funding from outside in- 
vestors. In order to pitch them on your idea and business model, you and your coworkers create a 
20-slide pitch deck that you present during investor meetings. The pitch deck is composed of the 
following: 


e 1x Title slide 

e 3x About the company slides 

e 3x Marketing problem slides 

« 5.x Solution/product slides 

e 4x Customer metrics slides 

e 4.x Business + revenue model slides 
e 1x Contact information slide 


2 () YEFFORT 
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At the end of the pitch, the investors tell you they are interested and want to invest in your idea. 
When you ask what sold them, they say it was all about your business model and revenue. Even 
though you put together 16 other slides, those 5 were what sold the investors. 


In this case, 20% of your slides (input) produced 80% of the successful outcome (getting an invest- 
ment). Though some of the other slides likely helped, the bulk of the action was taken because of 
only a small portion of the work. 


The other 80% of the input may be necessary to provide support but your overall focus and attention 
should be on ensuring that you have a strong 20% that will move your audience toward action. 


HAVE A BIAS TOWARD SIMPLICITY 


Just as you want to be bias toward action, you should lean into simplicity to communicate to your 
audience. Starting simple and adding layers of complexity and information as needed can ensure 
that you only provide your audience with what they need to take action; nothing more, nothing less. 


By focusing intently on only what is necessary, your audience will have less work to do and will free 
up their time and attention to take the desired action. If you demonstrate respect for their time and 
understanding, they will respect your request. 
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CHAPTER 5 
Thought Experiments + First Drafts 


oo often, communicators want to jump directly into the doing. They want to start writing, 
designing, or preparing materials to communicate to their audience as soon as the need 
arises. While being biased toward action is an important part of being an efficient commu- 
nicator, rushing to the creation stage generally does not produce the most effective communication. 


Doing thought experiments, creating first drafts, and throwing it all out are important steps toward 
creating communication materials that add value for your audience. Anyone you would consider a 
good communicator is likely accustomed to running thought experiments and writing terrible first 
drafts. These are essential parts of the writing process, and if you skip ahead, you risk endangering 
the value, credibility, and effectiveness of your final product. 


TERRIBLE FIRST DRAFTS 


Even if you consider yourself a good writer already, it is unlikely that you always produce your best 
work just by writing out your initial thoughts and ideas. First drafts are intended to be a place for 
your ideas to escape. A place where you can muse on your ideas and put them next to one another 
so you can see how they may connect. 


Writers who procrastinate often find themselves relying on their first draft to be something deliver- 
able to an audience. That approach, although it might be viable for a time, does a disservice to your 
audience as well as your ability as a communicator. 


By the time your audience sees your work, it should be on its third or fourth draft. This does not 
necessarily mean that it should take longer to create, it just means that you should be focused on 
iteration and revision, which we get to later in this book. 


The first draft should be something you are comfortable throwing out altogether. Starting over from 
scratch is still viable at this stage. For those whom writing does not come easily, this can be a difficult 
prospect to stomach. How can you throw away something you have put so much time and energy 
into? The answer is that you must. It is part of the process. 


In a more formalized process, the first draft could be thought of as a rough outline with margin 
notes. This approach usually comes out as a general format for the content with half-baked notes on 
what could be included in each section. You would not give your outline to your audience and call 
it good, so why give them a first draft and expect better outcomes? 


There are four purposes the first draft serves in the larger scheme of the writing process: 


1. Gets your ideas out of your head and into a tangible format that can be edited, revised, expand- 
ed upon, or removed later. 

2. Creates general organization for your deliverable without boxing yourself into a predetermined 
format. 

3. Serves as a point of comparison for your audience analysis and purpose statement. If they do 
not align, then now is a good time to go back and look at your inputs. 

4, Illustrates the necessary elements from the unnecessary. You can trim anything that does not 
add value for your audience or move them closer to the desired action. 


Writing a first draft should not be a luxury in your writing process, it should be a required founda- 
tional practice. 


THOUGHT EXPERIMENTS 


Thought experiments are most often associated with philosophy, but they can be a valuable resource 
for critical thinking in all disciplines. As a technical communicator, doing thought experiments at 
the beginning of a project can be a helpful way to align your ideas with the desired outcomes. It can 
also help you approach a problem or complex project from a fresh perspective. 


When doing thought experiments, remember that they are not intended to be reflective of what 
your final deliverable looks like. Often, thought experiments are too extreme to be effective as deliv- 
erables, but they can provide insights you can use along the way. 
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Engaging in thought experiments shows you the limits of what you know and what you should at- 
tempt. To improve your decision-making throughout the writing process, you should be willing to 
think through all of the different possible paths that can get you to your action or outcome. 


A few questions that can serve as a starting point for thought experiments related to your content 
creation are as follows: 


¢ What would this look like if it were easy? 

« What if this were delivered in person versus virtual? 

¢ What would this look like in virtual reality? 

¢ How would this be different if my audience had no prior knowledge of the topic? 
¢ Is there anything I would change if this was delivered in a different language? 


These questions can stretch the way you think about your writing and communication methods and 
can either reinforce best practices or push you to step outside the box to create a better experience 
for your audience. 


THE FIVE WHYS 


In the section on first principles, we discussed that every part of the writing process can be broken 
down into foundational elements that exist outside assumptions or conventions that have been lay- 
ered on them over time. 


You can build on this type of thinking when you begin the drafting process. As you think about each 
element of your communication, ask yourself the five whys. Applying this to the foundational pieces 
of your own writing can provide additional clarity and ensure that you are including only what is 
essential for your audience to take action. 


For example, applying it to your audience could look something like the following: 
“My audience is comprised of factory workers at the assembly plant.’ 
“Why?” 

“The factory workers are the ones using the machines we are writing about.’ 


“Why? » 
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“They are the ones whove been hired to do the work.” 

“Why?” 

“There is demonstrated demand for these widgets.” 

“Why?” 

“Because people need to be able to perform the task the widget does faster than they do now.’ 
“Why?” 

“There are more demands on their time than they have had in the past.” 


This scenario, though vague, can help you better understand who your audience is and the motiva- 
tion driving their actions and systems. In this instance, although we know our audience is factory 
workers, through the five whys it becomes clearer why the audience exists in the first place and what 
motivations they may have to take action based on your communication. 


Thought experiments of this type can have a profound impact on the quality of your writing and 
take only a few minutes to execute. The return on your time investment is high, especially for the 
audience. 


FINAL THOUGHTS ON WRITING + CRITICAL THINKING 


As we move into the tangible writing strategies and best practices that make up the bulk of the tech- 
nical communication practice, it is important not to lose sight of how critical thinking and using 
writing as a method of deepening your thinking on a topic or process can accelerate your path to 
being a better communicator. 


Starting with high-level concepts gives you the insight and foresight necessary to deliver content 
to your audience that adds value and biases them toward action. Writing is not just the output of a 
project, but it is also the output of the planning stages that ensure that there is a clear throughline in 
your work. Inevitably, this creates a more concise, consumable, and actionable deliverable for your 
audience. 
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CHAPTER 6 | 


echnical communication is a form of communication that you encounter every day. Though 
you engage with it daily, you may not notice technical communication when you see it. Tech- 


nical writing tells a story by communicating information that enables the reader or audience 
to interact with technology and solve complex problems. It is much different than the type of writ- 
ing most people are first exposed to, which is often creative in nature. 


Technical communication seeks to remove any assumptions the reader may have and convey the 
information in a clear and effective manner that enables them to one or more of the following: 


« Makea decision 

e Complete a task 

e Understand a complex concept 

¢ Persuade them to agree with your idea or proposal 

e« Communicate with others on a concept across departments, organizations, and continents 


This is the primary difference between technical and creative writing: creative writing urges readers 
to use their imagination, while technical writing seeks to eliminate imagination and assumption 
unnecessary. 


In order to aid an audience in performing a task, answering a question, or making a decision, we 
have to provide information that is both technically accurate and easy to understand. The concepts 
and best practices related to technical communication will provide you with a framework to do just 
that. 
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In a way, the less you recognize technical communication in the wild, the better job it is doing of 
helping you engage with the technology around you. 


WHY TECHNICAL COMMUNICATION MATTERS 


Technical communication is not limited to documents. Technical communication is any form of 
communication that helps people navigate and use complex technology. One prominent example 
of this is a stop sign. 


Stop signs allow people to use their cars (complex technology) in a way that is safe and effective. 
Safety is paramount when it comes to driving a vehicle, so stop signs were created with technical 
communication best practices in mind. 


A stop sign: 


* uses a unique shape that can be seen from long distances; 

« has the word “STOP” spelled out clearly, in large letters that are a contrasting color from the sign 
(which is critical for people who are color blind); 

¢ uses a vibrant color that universally means “stop”; and 

e is the same across all countries and cultures. 


A person driving in any country or location can immediately recognize what the sign means even if 
they cannot read the language or are color blind. This enables people to travel safely without forcing 
them to learn a new signal whenever they travel. 


A stop sign is the epitome of good technical communication: direct action, universal understand- 
ing, and clear audience and purpose. 


Without effective technical communication, many of us would struggle to complete daily tasks. We 
must be able to identify when and where technical communication is necessary, why we need it, and 
who it is for. At its worst, bad technical communication can cause potential chaos and frustration. 
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CORE CONCEPTS OF TECHNICAL COMMUNICATION 


Creating clear and effective communication can seem overwhelming, but there are six core con- 
cepts of technical communication that make it easy to spot and communicate technical information 
effectively. 


These concepts help simplify technical communication and provide a framework for your own writ- 
ing and content development. 


¢ Reader centered. Effective technical content is laser focused on ensuring that the reader has all 
of the information they need to take action or make a decision. The writing process begins with 
identifying your audience and purpose, which we cover in detail in the next chapter. 

¢ Accessible + effective. Technical documents should be accessible by all who need it, meaning 
that not only is it delivered in a way that everyone has access to, but it should also be written 
in a style and with the language necessary for all who need to understand it. A good technical 
document effectively enables the reader to take action or make a decision. The information and 
request should be clear without assumptions on the reader’s part. 

¢ Meaningful content. The content you provide in a technical document should always be mean- 
ingful for the reader. This means that the content should be relevant to the topic at hand and 
that it includes only what they need and nothing more, nothing less. 

« Effective organization + design. The design and organization of a document should never get 
in the reader’s way of understanding the information. The use of headings, subheadings, and 
ample white space allows the reader to skim the document effectively. 

« Appropriate tone + style. Once you understand your audience, you can better write in a tone 
and style that enables them to connect to your information. This provides a path to quick and 
efficient processing and decision-making. 

¢ Supporting visuals. Nearly all effective technical communication contains relevant and redun- 
dant visual elements. These visuals can come in the form of charts, graphs, illustrations, or 
photos. Regardless of their format, the visuals should always add to the reader’s understanding 
of the document. 


An understanding of each element will ensure that you create effective technical documents and 
materials. 
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COMMON TYPES OF TECHNICAL COMMUNICATION 


Technical communication can take many forms. Here is a brief list to help you begin to understand 
how and when to use technical communication concepts. 


e Instructions 

e User manuals 

¢ Reports (analysis or informational) 
« Emails + memos 

¢« Procedures 

¢ Road signs + product tags/labels 


These forms of communication require clear and effective technical writing to ensure that they are 
understood by their audience. There is no room for ambiguity or assumptions. 
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CHAPTER 7 
Audience Analysis 


udience and purpose are the core of technical communication. To create anything of val- 

ue, you must first know who you are creating it for and why you are creating it. Without 

an understanding of these two elements, your writing and communication efforts will be 
ineffective. 


This chapter provides you with the tools necessary to discover and analyze your audience as well 
as determine your purpose and how to create content specific to that purpose. Getting clear about 
your audience and purpose will create a strong foundation for your chosen communication method 
and message. 


GET TO KNOW YOUR AUDIENCE 


One of the biggest mistakes communicators make is attempting to create content for everyone. 
When they sit down to write or create, they do not have anyone in particular in mind, or worse, they 
have an audience in mind but it is too broad. Having a broad audience will ensure that you reach no 
one. Trying to widen your net can only be successful once you have refined your audience as much 
as possible to see what works and what does not. Only from there can you begin to expand. 


If generalities and vagueness are the enemies of effective technical communication, then specificity 
and clarity are the remedies. There are several steps you can take in order to get clear about who 
your audience is and what their needs are: 
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1. Perform an audience analysis. 
2. Assign a persona to your audience (when a specific person or group is unavailable). 
3. Have a member of your intended audience available to review your information. 


AUDIENCE ANALYSIS 


To understand your intended audience, you have to narrow them down to one person. Ideally, they 
would be a real person you can research and visualize as you write and create. Getting to know your 
audience—who they are, what they need, what they value—requires research, it is not something 
you can do within a silo. You are not your audience. 


The task of identifying your audience is something that should happen for any project or piece of 
communication, no matter how big or small. Though the time spent identifying your audience for 
an email will be shorter than for a company-wide document or external proposal, the general pro- 
cess should remain the same. 


The audience analysis worksheet (Figure 7.1) can be used as a starting point for getting to know your 
target audience better. 
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Overview 


[This is where you describe the why (i.e., why are these audiences relevant for the client?) and how 
you did the research/landed on these audiences. ] 


Primary Target Audience 


Summary 
[Who is this audience? What are their motivations?] 


Snapshot 
Gender, where applicable (does not need to be binary) 
Age range 
Where do they live/where are they located? 
Education level, where relevant 
General disposition characteristics (busy, tired, energetic, etc.) 


What makes the audience feel satisfied or successful? 
[Providing for their family, doing something good for the environment, saving money, etc.] 


Barrier or challenges they face 
[Getting quality products without spending too much, not having enough time to do research, etc.] 


How the vendor/website solves their problem 
[Provides end-to-end service, does all of the research, one-click ordering, low-cost products, etc.] 


Decision criteria 
[How do they decide if they should make a purchase/take an action®] 


FIGURE 7.1 AUDIENCE ANALYSIS WORKSHEET. 
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PRIMARY VERSUS SECONDARY AUDIENCES 


Nearly all forms of communication have more than one audience. But having more than one audi- 
ence does not mean you are trying to create something for everyone. Audiences can generally be 
segmented into two groups: primary and secondary. Your primary audience is the one you want 
to take specific action. You want to ensure that whatever you create is something that can be easily 
understood and used by your primary audience. Your secondary audience is a group of people who 
may need the information for certain purposes, but it is not a critical piece that they need to perform 
an action (and they may not have any action items come from the document). 


For example, imagine you are an architect drafting a set of blueprints for a contractor. The primary 
audience is the contractor because they need the exact measurements and specifications to be able 
to order materials appropriately and perform many other tasks that need to be done with precision. 
However, your blueprints will likely be seen by city inspectors, the homeowner, and so on. While 
the blueprints are useful to those groups, you should not create the blueprints to match their level 
of understanding or expertise because then the primary audience, the contractor, may not be able 
to do their job effectively. 
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CHAPTER 8 
Purpose + Action 


he purpose of your communication and the associated action are the guideposts for any 

content creation that follows. Without purpose and action, the act of writing will be difficult 

because there will not be a clear path forward. The more you can establish that clear path, the 
easier the writing process will be. 


Let us break down the difference between purpose and action and how to use them to establish a 
foundation for the rest of your content. 


FINDING YOUR PURPOSE 


Identifying your audience is only the first step to creating effective communication. To communi- 
cate effectively, you must also have clear intent and purpose. Generally, writing and communication 
occur out of a need. A need to answer a question, to give direction or instruction, or to express an 
idea. Too often, the need is assumed to be the same as the purpose. Though they are linked, the need 
is the general and the purpose is the specific. 


The core characteristic of technical communication is its specificity. That specificity has to occur 
at each phase of the writing process, including the research and discovery phases. Similar to your 
audience, you can have a primary and secondary purpose, but each of them must be limited and 
specific in their scope. 
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Let us say, for example, that you are an excellent cake decorator and you want to write a guide to 
decorating cakes. The “need” in this scenario for someone reading your guide is that they want an 
amazing cake for their event. However, there are a lot of elements that go into having an amazing 
cake, not just how it is decorated. If you follow the need rather than the purpose in this situation, 
your guide would likely lack focus, trying to instruct the reader on how to make a cake, potential- 
ly including a cake recipe, including a discussion on how to transport the cake, and so on. This 
document would not be valuable for someone specifically looking for a guide to cake decorating. 
Therefore, the purpose of your document is to help the reader decorate the cake; the other details 
including the recipe, transportation methods, and so on should not be included. 


If you determine the secondary purpose would be to show them how to transport the final product, 
then you could include that as additional reading or an appendix, but it should still have its own 
place, not as part of the main guide to decorating. 


CALL-TO-ACTION 


Finding the purpose of your document or presentation does not have to be complicated. The pur- 
pose can be narrowed down by thinking about your main call-to-action. A call-to-action should be 
included in all technical communication and is the specific action you want the audience to take 
after reading your document. Before you start writing, you should have an action in mind. 


The action could be to perform a task, make a decision, do further research or reading, or a combi- 
nation of all the three. If you cannot think of a task that your audience should take after consuming 
your document, then you should rethink whether or not it needs to be created at all (or if it needs 
to go in a different direction). 


If you can get to your action, then your purpose will be clear. In the above example of the cake dec- 
orator, if the action you want your reader to take is to go out and decorate their next cake, then that 
is the core purpose of your document: to give them the information they need to be able to perform 
that task and only that task. 
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PURPOSE-DRIVEN CONTENT 


Any and all content you put into your document, regardless of the medium or delivery method, 
should get the audience closer to being able to take the action you have decided on. Any content 
that distracts from your core purpose or leads the audience away from the action should be omitted. 


This is the reason why a guide on cake decorating would not include information on making the 
cake itself. It may give suggestions on recipes or the type of cake, but it would not include the actual 
recipe or method because it would lead the audience away from the core purpose of giving them the 
information needed to decorate a cake. 


If you are searching for a guide on decorating a cake and your guide starts with three pages on how 
to make the cake itself, you will likely lose the attention of your primary audience. They want the 
title of the document to reflect the content, which, in turn, reflects the audience and purpose. 


WHERE AUDIENCE, PURPOSE, AND ACTION INTERSECT 


The final step in this discovery and refinement phase is to put all of it together: the audience, pur- 
pose, action, and content. The place where all of the pieces fall into place is the title or name of your 
piece. It may seem like a small thing, but the title of your piece of communication is the guide and 
benchmark for the entire document. 


Your title should provide the audience with the understanding of who it is intended for, what it will 
cover, and what the outcome or action should be. Having a title that matches the content builds your 
credibility as an author and ensures that your audience gets exactly what was promised. A generic 
or misleading title can derail otherwise great content, so it is worth spending the time to craft one 
that is meaningful. 
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CHAPTER 9 \ 


Technical Communication Framework 


f your only takeaway from this book is that you have a new sense of urgency for getting clarity, 

then you will be set up for success with your communication moving forward. The common 

theme in technical communication is clarity. We want clarity every step of the way and it needs 
to be replicable so that we are not reinventing the wheel every time we sit down to write. 


Getting your guideposts in order with the audience, purpose, and action is useful on their own, but 
putting them into a process or framework can accelerate your writing efforts in the long term. 


These frameworks will push you to think more deeply about the technical communication process 
and can be applied situationally in the workplace to make your writing more efficient and effective. 


COMPETENCE FRAMEWORK 


At a high level, a competency framework defines the knowledge, skills, and attributes needed for 
people or roles within a given organization. The set of competencies assigned to a role will have a 
direct impact on how efficient and effective an employee will be given their particular set of skills 
and knowledge. 


In order to create this type of framework, you have to have an intimate knowledge of the roles and 
accountabilities within your organization. This type of thinking can be applied to technical commu- 
nication when defining your audience and purpose. 
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If you set out with the idea that your deliverable is providing a specific set of information to a role 
that has defined competencies within an organization, it becomes much easier to create a sketch of 
your ideal audience. 


Each audience has a set of core competencies related to their role, whether it is internal or external to 
your organization, and those competencies directly relate to the output and outcomes of their role. 


Your deliverable should be tailored to their competencies so they can be more efficient and effective 
in their role. Understanding their competencies also allows you to see what their level of technical ex- 
pertise is, what their shared backgrounds or experiences are, and what their desired outcomes may be. 


This framework can be applied to any deliverable during the audience analysis stage. 


INNOVATION FRAMEWORK 


Organizations want to ensure that their positioning is stable in the current environment as well for 
the future. As such, technical writing and communication needs to consider not only the present 
needs of their project but also future needs. 


The innovation framework provides a way of looking at your deliverables that ensures you are 
adapting your communication methods to the future needs of your organization. The way people 
interact with content has changed and will continue to evolve. As a communicator in your organi- 
zation, it is not necessarily about the technology itself, but about information and how we develop 
audience-focused content, regardless of the medium. 


If you want to deliver content to your audience that meets them where they are and serves their 
unique needs, then developing an innovation framework can ensure you are setting your organiza- 
tion up for long-term outcomes. 


The key components of the innovation framework are communication, collaboration, and effective 
processes to manage change. In practice, this is essentially framing up your communication within 
oop. As we have discussed with editing and revision, writing is not a means 


to an end, but an ongoing process that enables the sharing of information in a clear and concise way. 


} 
i 


a consistent feedback 


Ifyou apply this framework to your own work, you allow for open communication and resource-shar- 
ing from the beginning. It also takes the pressure off in some ways because you begin the project 
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knowing that you are working with a team and that the tearn will work to consistently revise, add to, 
and improve the deliverables you are working on. 


COGNITIVE LOAD FRAMEWORK 


Creating material that is concise yet thorough is a main tenet of technical communication. The goal 
is to provide enough information for your audience to make a decision. No more, no less. The cog- 
nitive load framework can be applied to your deliverables to ensure that you only focus on what is 
necessary for your audience to take action. 


Though the technical definition and theory behind cognitive load can get abstract, the main take- 
away for technical communicators is that we should design documents, presentations, and other de- 
liverables in a way that shares only the amount of information the audience can reasonably process 
and understand within the time frame in which it is shared. 


Putting your audience and purpose through a stress test using the cognitive load framework can 
improve your overall output by measuring what you believe is necessary for your audience to take 
action and what you see as being a reasonable amount of information to process in a given setting. 


This can enable you to better understand the type of delivery method for your information as well 
as how to break up the content and organize it for a better audience experience. 


NARRATIVE FRAMEWORK 


A narrative framework is more commonly used in creative writing; however, it can be a helpful 
framework for organizing your deliverables for a better audience experience. 


The core components of a narrative framework are characters, setting, plot, conflict, and resolution. 
These story components keep the document running smoothly and allow the information to devel- 
op in a logical way that the audience can easily follow and digest. 


The characters in this scenario are your audience. You want to build a story that puts them at the 
center. In technical writing, we sometimes refer to this concept as “reader centered.” The setting is 
what provides the context for the audience. It is what they need to know to understand why this 
information is being presented to them and what has led to this point. 
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The plot and conflict are the how and why of the deliverable. The plot helps the audience understand 
what path they should take to resolve the conflict or the reason why the information is being pre- 
sented. The resolution in this case would be the call-to-action. The action the audience takes after 
processing the information is what will lead to improved or desired outcomes. 


Sometimes simply applying a different perspective to your writing process can help refine the orga- 
nization and accessibility of the information you are presenting. Setting your technical document 
up with the same organization as a story would have is a way to give the audience a sense of famil- 
iarity and to ensure that you are covering all of the necessary angles for the audience to walk away 
with a full understanding of the information and clear path forward to action. 


PUTTING FRAMEWORKS TO WORK 


These frameworks are not as tangible or actionable as many other concepts included in this book, 
but they can be a useful way of stress testing your initial assumptions and sharpening your output 
to better align with your audience's expectations and capabilities. When used along with the critical 
thinking topics and the tangible, foundational items we have covered, you can apply them to your 
deliverables, which we cover in the next section. 


AO Technical Communication Essentials 


SECTION 3 & 


DOCUMENT 
AND DELIVER 


a _ 


: 


‘J ’ 4p \« ~eie 
o pert etd - 


>< Ge 
a) 
7 or 68 Wy 
Ss 
a = ab = 
7 Ss ae _ 
r ; 
- a 
He » - a * : ; : 7 
eS. ACA ALS ae 
; 7 
ag ‘S 
: @ : 
a : Mar j ‘ = _ - > oy ue. 
_ a TS ; 7 ad 
ie oe vy —" Oe 
%, 7 
’ 4 A 7 a= ry e 
’ 1 


oc TWaMUDOG i 
#4V1J30 aA 


| 7 a 
ee a 
ae . 


i. 


. ee co oe 


CHAPTER 10 
Document Organization + Design 


ighty percent of the work of creating technical documents is in the planning and research 
phase. The actual writing takes the least amount of time. This is often referred to as front- 
loading. 


Front-loading the work is what enables you to create effective documents quickly without struggling 
with where to start. This process starts with identifying your audience and purpose; it is the single 
most important thing you can do to improve your writing and communication. 


Once you have figured out those two pieces of the puzzle—your audience and purpose—it is time 
to start thinking about how to use the information to begin building your document. That is where 
organization and design begin their work. 


PRINCIPLES OF ORGANIZATION 


Effective organization is a critical component of ensuring your audience understands the informa- 
tion you provide. In order to understand what you have written, the document needs to be orga- 
nized in a way that makes sense to the audience, which does not necessarily mean it is organized in 
a way that is most logical to you. 


The audience analysis is an essential starting point for organizing your content into a format that 
is easily understood by those you intend to use and read it. The below principles of organization 
are the building blocks necessary to start organizing your research and information into a readable 


format. 


43 


These principles are widely applicable. Regardless of the type of document or communication ma- 
terials you are creating, applying these principles will ensure that the structure of the informa- 
tion does not impede the reader from understanding it. This is not about diagramming sentences 
but about understanding how to formulate coherent and effective documents through a solid base 
knowledge of content structure. Let us take a closer look at the individual principles. 


Topic SENTENCES 


Topic sentences are the first sentence of a paragraph (and sometimes the only sentence), and as 
such, they set the tone and agenda for the rest of the paragraph. A document's organization starts at 
the micro level: the sentence. A good topic sentence sets up a good supporting paragraph and para- 
graphs make up a full document. When viewed with this lens, it is easy to see how a solid document 
begins with concise, to-the-point topic sentences. As a general rule, a topic sentence should be able 
to stand on its own as a full paragraph if needed. 


SUPPORT PARAGRAPHS 


Any paragraph in a document is considered a support paragraph. These paragraphs support the 
preceding topic sentence by offering additional information and deeper insights, which provide 
clearer understanding for the reader. Support paragraphs are the building blocks of a document and 
contain information that move the reader forward and give them the tools to take the necessary next 
steps. These paragraphs contain various types of information and should be separated by headings 
and subheadings. 


PARAGRAPH UNITY + COHERENCE 


Each paragraph should contain only one main idea to prevent confusion for the reader. When you 
begin to introduce a new idea, even if it is closely related, you should begin a new paragraph with 
a new topic sentence. Paragraphs within close proximity to one another should contain similarly 
relevant ideas. If shifting to an entirely new topic, you should either break up the document with a 
heading or save it for a separate document or appendix. 
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PARAGRAPH LENGTH 


Paragraph length can vary wildly depending upon your document’s audience, purpose, and delivery 
medium. Contrary to what you may have been previously taught, a paragraph can be as short as a 
single sentence, granted they meet the abovementioned dependencies. Most paragraphs will range 
from one to five sentences. Though paragraphs can be longer, it is important to note that technical 
documents benefit from being easily skimmed, and long paragraphs can make that challenging. 
There is no hard and fast rule to paragraph length other than it should be as long as necessary (and 
no longer) to provide the necessary information to support the given topic sentence. 


ELEMENTS OF ORGANIZATION 


The principles of organization outline the top-level requirements for any type of written communi- 
cation. However, within the principles are various elements that can be used in order to structure 
your document appropriately. The following are some key elements of organization that you can and 
should use in your own documents to ensure clarity and coherence for your audience. 


TABLE OF CONTENTS 


A table of contents provides an upfront structure for your audience. At a glance, a strong table of 
contents essentially serves as a summary of your document and sets appropriate expectations for 
the reader. The table of contents is a critical component of creating a document that is skimmable; 
however, it is important to use clear and limiting headings to ensure the content is straightforward. 


CLEAR + LIMITING TITLE 


As with the table of contents, creating a title for your document that is clear and limiting enables 
your audience to understand, at a high level, what the document is about. It sets their expectation 
for what is to come and provides initial context for the information contained in the rest of the doc- 
ument. In addition to ensuring the audience knows what the document is about, having a clear and 
limiting title also helps you, as the writer, to stay on track. The more limiting your title is, the less 
likely you are to add superfluous, irrelevant content to the document. 


CHAPTER 10: Document Organization + Design 45 


EXECUTIVE SUMMARY 


An executive summary expands on the title and table of contents by providing a more detailed de- 
scription of the document itself. It is important to remember that with technical writing, there is no 
reason to hold back on revealing the conclusion of the document; you want to be as upfront about 
your findings or call-to-action as possible. 


The length of the executive summary should be reflective, proportionately, of the length of the entire 
document and should provide some of the core concepts from the introduction, body, and conclu- 
sion. You want to give away all of the best parts of your document immediately in the summary. 


The purpose of showing your audience the most interesting pieces of information right away goes 
back to the idea of skimmability. If a decision maker or key person in your audience is short on time, 
they need to be able to get a clear understanding of your document by reading the summary, with an 
opportunity to dig deeper into the rest of your document when they have time. 


HEADINGS + SUBHEADINGS 


Headings and subheadings are what make up your table of contents and should be appropriately 
clear and limiting. Headings and subheadings provide direction for your reader and help them 
understand which sections they need to pay attention most. From a skimmability perspective, de- 
scriptive (do not confuse with long) headings and subheadings are the most important device for 
allowing a quick and effective scan of a document by your audience. Headings and subheadings 
should be used early and often throughout your document while ensuring you do not break the flow 
of ideas or thoughts between sections or paragraphs. 


PRINCIPLES OF DESIGN 


As with organization, the design of a document plays an important role in how an audience pro- 
cesses the presented information. The essential component of organization and design is that the 
look and feel should never interfere with the information itself. Any time you make the information 
harder to read or understand, you do your audience a disservice and can potentially render the 
document ineffective. 


It is tempting to want to overthink how a document looks. This is especially true if you are prepar- 
ing a document for an important occasion such as a job interview or big presentation. Often, the 
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catalyst for overdoing the design is wanting to add interest and aesthetic appeal to a document. 
However, with technical or complex documents, the information should be center stage, not the 
design. The best indicator that you have done the design properly is that you do not notice it has 
been designed at all. 


Using the elements of design appropriately, you can create a document that is clean, clear, and free 
of distraction. This ensures that your audience can digest the information presented to them with- 
out being pulled in other directions. The principles of design outlined below are the framework for 
creating a document that delivers your information as you intended. 


IMPORTANCE OF INFORMATION 


Design in technical documents should always serve a purpose. It should never be added for purely 
aesthetic purposes. Using design elements such as bold, italics, and underline can signify important 
information for your reader and should be used to direct their focus accordingly. 


When design elements are used appropriately, the importance of information becomes immediately 
clear to the reader and can aid in effective skimming and understanding of the information present- 
ed. When used incorrectly, design elements can distract the reader and pull their attention away 
from the important information. It is also critical that any elements you use to signify important 
information are used consistently throughout the document to eliminate possible confusion. 


Focus 


The design of your technical document should emphasize and guide your audience's focus. Using 
elements such as whitespace and headings can create focus for your reader and help them under- 
stand the “road map” of your document. Any design element that could potentially distract your 
reader from the focus or call-to-action of your document should be eliminated. As with the text, 
design elements should be used sparingly and with specific purpose so that you and your reader 
stay on track. 


MEANING 


Using the appropriate images, graphs, and diagrams can create a deeper level of understanding and 
can add clarity to complex ideas. Design elements should add meaning to the textual elements of 
your document and should do so in a way that is easily understood at a glance. If the meaning of 
your concepts or ideas can be more easily derived from a visual or design element, then it should be 
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a significant part of your document. Be careful to avoid using design elements that could confuse 
the meaning of your document or could lead to a biased understanding of the text. 


REDUNDANCY + CLARITY 


Though repetition and redundancy are often looked at negatively, redundancy in technical docu- 
ments can provide much-needed clarity to complex ideas. Providing the same information in differ- 
ent ways ensures that your audience comes away with the knowledge and understanding necessary 
to take appropriate action. In design, redundancy is achieved through visual aids that illustrate the 


information stated in the body text. 


alexeenko alexey/Shutterstock.com 
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ELEMENTS OF DESIGN 


The principles of design provide us with an understanding of how and why we use design in tech- 
nical documents. However, the elements of design give you specific tools and solutions for creating 
effective document design. Let us take a closer look at some of the core elements of design. 


WHITE SPACE 


White space functions as a way to give your audience space to think about the ideas and concepts 
you present in your document. Leaving ample white space ensures that there is not too much infor- 
mation on each page and that you do not overdesign the document. This does not mean that your 
margins should be set to larger than normal or that you should put unnecessary space between ele- 
ments. Being aware that white space is necessary will remind you to use headings and subheadings 
more frequently, which also has the effect of making it easier to read and digest. 


FONT TYPE + COLOR 


Often when we want to grab a reader’s attention or bring their focus to something we feel is im- 
portant, we use font changes and various colors to do so. While this approach may work for graphic 
design or marketing materials, in a technical document, changing the fonts and colors is more of a 
distraction than anything. Even if it only briefly causes your reader to lose focus, it can cause your 
reader to question your credibility or distract them from the most important information. Sticking 
to common font families and sizes as well as basic colors such as black and dark blue (where needed) 
ensures minimal distraction. 


IMAGES, GRAPHICS + ILLUSTRATIONS 


In technical writing, images, graphics, and illustrations should be used to add clarity to a complex 
concept. It does not provide a design or aesthetic function as much as it provides redundancy to the 
text. Images, graphics, and illustrations should be used as needed for the level of audience under- 
standing and should not introduce new ideas that are not present in the text. In addition, any visuals 
used should be labeled appropriately and sized similarly. Only use high-quality, easy-to-understand 
visual elements in your document. 
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GRAPHS + TABLES 


The use of graphs and tables in your document follows many of the same guidelines as images, 
graphics, and illustrations. They should be used to clarify information in the text and should be 
labeled appropriately for reference purposes. Unlike images, graphics, and illustrations, graphs and 
tables can be used to introduce information not explicitly written in the text. Graphs and tables 
should be used to represent data that are more easily understood visually than in text format. 


CHUNKING 


Chunking refers to a method of design that organizes the information in your document into re- 
lated clusters. Chunks of related information can be set apart from other information by headings, 
subheadings, and white space. It gives the reader a visual queue as to which information in your 
document is related and can aid in effectively scanning the information. 


PUTTING IT ALL TOGETHER 


Organization and design go hand in hand for creating an effective technical document. Using them 
together appropriately, the organization and design can be just as powerful as the actual text when it 
comes to getting your audience to take the desired next steps. Good organization and design should 
go unnoticed by your audience and provide a distraction-free environment in which to consume 
and digest the information it contains. 


While many of the concepts of organization and design seem to overlap, it is important that you 
plan for them separately. Organization should come first when you begin outlining your document, 
and design should fill in the gaps as you begin writing the document. They should support one an- 
other but should be viewed as separate entities. 


50 Technical Communication Essentials 


CHAPTER 11 \ 9 


eh 


Research, Documentation, and Summa 


he chapters and topics in this book build upon one another the way they do for a reason: 
you want to frontload as much as possible; you want to do as much of the work of writing as 
possible before you ever actually start the document or final deliverable. 


— 


Not only does this process help you with putting words to paper when the time comes, but it also 
assists you in the research phase of a writing project. Casting a wide net during the research stage 
has its place; however, it is often overwhelming and can easily guide your writing project directly off 
the track it was on. 


This chapter explores the research process including what it means to effectively document and 
summarize your findings in order to jumpstart your writing. It is critical, however, that you under- 
stand and refer back to the previous concepts often because if you do the work of identifying your 
audience and purpose but never refer back to them during the rest of the document creation pro- 
cess, you will find yourself starting from scratch every time you get back to working on your project. 
If you do not use the concepts we have reviewed, the work you have done is rendered useless. 


Being able to communicate well is just as much about being efficient with your time and energy as 
it is about writing clearly and professionally on a given a topic. It is not enough to review and un- 
derstand these concepts, you have to commit them to memory and engage with them during each 
writing project you take on. 
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THE RESEARCH PROCESS 


At some point in your academic career, you have completed a research project. Whether it was a 
paper or presentation, you had a deliverable that required some research followed by putting that 
research into written format. The common approach to a research project is to pick a topic (or 
sometimes, the research process starts when trying to find an appropriate topic) and then begin 
searching online for anything related to it. This process generally leads to a feeling over overwhelm 
and disjointed thinking. 


Convention tells us to start big and get smaller as you go. However, in technical communication, 
the reverse is often the most effective, even if it is counterintuitive. Starting with a narrow focus is 
nothing to fear, you can always expand your search if you are not finding enough information or the 
right type of information. Starting with too broad of a topic, however, can get your project off track 
quickly by presenting you with information that is either unrelated to your specific project or not 
the right type of information to support your claims or position. 


THE PURPOSE OF RESEARCH 


The purpose of research in the technical writing process is to support your argument. Whether or 
not your topic is a typical argumentative piece is inconsequential. All technical documents are an 
argument to some extent because you are trying to persuade someone to take a specific action—you 
are, in essence, arguing for your position on the topic. 


During the research process, you will filter through what is relevant to your topic and use the most 
supportive and credible pieces to give authority to your writing. In addition, the process may open 
the door to angles or subtopics you had not yet thought of, and that is ok. The secondary purpose 
of research is to continue to refine your topic and it is important that you remain flexible to changes 
throughout the writing process. While having clarity and specificity is key, you must also allow for a 
change in position or direction if the research you are doing takes you down a new path. 
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STAGES OF RESEARCH 


The following are the stages of research that you should be actively thinking about during the pre- 
writing process. Following this framework ensures that your final document has the support it 
needs to be complete and effective. 


1. ASK THE RIGHT QUESTIONS 


Effective research begins by asking the right questions. All research should stem from a set of ques- 
tions that you want to answer for yourself and your audience as they pertain to your topic. Your 
topic is indicative of the overall scope of your document; however, there are likely a set of questions 
within your topic that you will need to answer in order to fulfill the document’s purpose. 


One way to explore potential questions you want to research is to create a question tree. Start with 
your topic at the top and brainstorm three to four high-level questions. From there, create two to 
three more questions from each of the original questions. Do this several times and then select the 
top five questions that you believe will provide the proper level of information to your audience to 
enable them to take action or make a decision (Figure 11.1). 


How should we present proposals to prospective clients? 


Is there a budget? Which delivery Who are our most 
: method is best? common clients? 


What materials Will it be in What size is 
do we need? person? the company? 
Are there travel Will we have Where are 
expenses? a projector? they located? 


Do we need to Who is What is their level 
cater? presenting? of technicality? 


FIGURE 11.1 QUESTION TREE EXAMPLE. SOURCE: ASHLEY FLITTER. 
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2. DETERMINE DEPTH + TECHNICAL LEVEL OF RESEARCH 


The depth of research you should aim to achieve should correspond to the technicality of your 
audience. By this point, you have adequately analyzed your audience so you have a grasp of how 
developed their technical understanding of your topic is. 


If you have a technical audience, you will want to aim for the deepest level of research, generally 
leading you to scholarly journals or specific professional publications. 


For a semi-technical audience, trade and business publications will allow you to dig deep enough for 
information that will provide the right mix of technical and general support. 


A nontechnical audience, or a general audience, generally requires a surface level of research that 
can come from popular media, blogs, websites, or other sources intended for general consumption. 


3. DOCUMENT + EVALUATE SOURCES 


Once you start finding relevant resources, it is important that you take notes and document your find- 
ings appropriately. Good documentation enables you to easily find information when you are ready to 
write your final document and ensures that the context and intent of the original document remains 
clear. If the documentation process is overlooked, you will often find yourself having to go back to the 
original sources time and again to pull out information, which is not an effective use of time or energy. 


Along with the documentation process, it is important to evaluate your sources and the information 
you distill from them to ensure that only the most relevant information makes its way into your final 
document. The evaluation process should be a review of your documented information alongside 
your original topic and research questions. Evaluating which sources and information align best 
with your purpose and questions creates a strong and consistent argument. 


4. VERIFY + SUMMARIZE FINDINGS 


Now that your information has been documented and evaluated, it is time to verify your supporting 
statements and summarize what you have discovered. 


Verifying your findings is the process of taking the claims you have documented and trying to find 
them cited elsewhere. If a piece of information can only be found in one source, then it likely has 
strong biases or has not been confirmed by others. If that is the case, then it may be best to avoid 
using this information in your own document so as to not weaken your credibility. 
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Once you have verified your findings, the final step in the research process is to summarize what 
you have found in your own words. Do not simply rewrite the information. The intent of a summary 
should be to develop a brief narrative of the findings without changing the original context or em- 
phasis. This part of the process deepens your understanding of the information and enables you to 
being thinking about how the information can be used in your final document. 


Following this process should decrease the amount of time and effort you put into research because 
you will be maximizing your time by staying focused rather than taking too many turns that push 
you further away from your topic and purpose. 


DOCUMENTING YOUR FINDINGS 


Once the research process begins, you will need to document any findings that you deem important 
or relevant to your topic. But it is not only the relevant content you need to pay attention to, the 
context of the content is just as important. 


Too often, articles and books we read (even the most professional and scholarly) cite studies, stats, 
and sources removed from their original context. When information is removed from its context, 
it can be manipulated, though not necessarily in malicious terms, to fit the topic at hand and the 
author’s purpose. 


Therefore, documenting your findings is not just about locating and taking notes on relevant ma- 
terial but also making note of the context and background information necessary to ensure you 
provide balanced and unbiased viewpoints in your final document. This is an important step in the 
research process that is often overlooked. 


FINDING RELEVANT SOURCES 


Documenting your findings begins by finding relevant and credible sources. Most modern research is 
done via the Internet and search engines rather than in a library, which has both upsides and downsides. 


Although there are millions of books available, a single library can only hold so many—it has a fi- 
nite amount of space and the number of relevant sources, depending on your topic, is limited. The 
Internet, however, holds an unlimited and endless number of resources that have the potential to be 


relevant to your topic. 
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But that is also a downside to doing research online—there are more sources than you could ever 
review or use. Determining which sources are most relevant actually starts with refining your topic. 


Similar to what was discussed in Chapter 2 regarding refining your audience, refining your topic 
and the scope of your document is essential to finding relevant resources without draining valuable 
time and effort. Your research should start with as narrow of a focus as possible so that the sources 
that bubble to the top are more likely to be highly relevant. 


Consider, for example, that you are creating a document on the topic “Email Marketing Strategies 
for Small eCommerce Businesses.” If you begin by searching “email marketing” on its own, the num- 
ber of results will be too many to sift through, and not only that, they will likely range from email 
marketing software platforms to the definition of email marketing. Neither one of those particular 
search results would be relevant to your topic. If you instead search using your exact topic, you are 
more likely to find relevant sources right away. 


In the case that your topic is too narrow, you can always start narrow and go wider if necessary. Casting 
the net too wide in the beginning ends up being an inefficient use of your time and can lead to using 
general resources in your document rather than sources that are specific to your actual topic. 


SOURCE CREDIBILITY 


Credibility is paramount for technical topics, and it is essential that your documents contain sup- 
port for any claims you make toward your argument. 


The limitless resources at our fingertips makes finding credible sources somewhat challenging. 
There are no (or few) gatekeepers to published information, so it is up to a document's author to 
ensure that the source is credible. Answering the following questions will ensure that you have done 
your due diligence when it comes to ensuring a source is reliable: 


¢ Who is providing the information? 

¢ Is the author(s) credible or known for their work on this topic? 
e Can you contact the author or find out more about them? 

¢ Has the source been referenced by other credible sources? 

¢ Is there a sponsor or affiliation (i.e., is someone paying for it)? 
« Who links to the page? Who do they link to or cite? 

¢ When was the source created or updated? 

¢ Can you corroborate the information in other sources? 
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In addition to ensuring your sources are credible, it is important for your own credibility that you 
present balanced viewpoints in your document. While you are trying to persuade your audience to 
take a particular action, technical writing is not based on opinion. Presenting balanced viewpoints, 
including exploring potential audience objections within the document itself, ensures that you pro- 
vide all information necessary for the audience to make a decision or take action. 


THE NOTE-TAKING PROCESS 


Once you have found your sources, it is time to start pulling out the most important and relevant 
information. This information may or may not be used later in the writing process to providing 
supporting claims for your argument. Even if you do not use the information directly in your doc- 
ument, any documentation you do will help guide your writing and add credibility to your final 
deliverable. 


Do not allow the process of documenting your findings become too cumbersome or complex. In 
its most basic form, documenting your findings is simply purposeful note-taking. Though this is 
not the same note-taking process with which you are likely familiar from classes. Note-taking in 
the context of documenting your research is not intended to rewrite what is being said—it is intent 
is to provide insights into the topic of your research that you will then use to persuade your own 
audience to take a specific action. 


Therefore, the note-taking process must be taken up with intent and purpose and should follow a 
general framework to ensure your notes are consistent, regardless of the time or type of research 
you are doing. 


With the proliferation of note-taking tools and resources, the way in which you take note is less 
important than the act of taking them and sticking to a simple process that suits your research and 
working style. 


SUMMARIZING THE RESEARCH 


Summarizing your findings is an exercise that has twofold benefits: (1) it allows you to gain a deeper 
understanding of the information and helps you begin to see how you can apply it to your topic for 
maximum effectiveness, and (2) it provides an opportunity to practice writing summaries, which is 
a critical component of an effective technical document. 
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SUMMARY EXPECTATIONS 


For a summary to be effective, there are several expectations and guidelines to follow: 


e Accurate—information in the summary should align with the context and emphasis of the orig- 
inal source. 

« Complete—to eliminate biases, the summary should include the breadth of information pre- 
sented in the original. 

¢ Readable—as with all technical documents, a summary should be written in a way that pro- 
motes easy scanning and understanding. Use transitions, vary the sentence length, and make 
connections where needed so that it is easy to read. 

¢ Concise—keep your summary short and to the point. 

« Nontechnical—even if your source or your audience is technical, your summary should be 
quick and easy to read and understand and free from jargon. 


The summary you develop from your research is the essential deliverable of the research process 
as a whole. The summary is what you will take with you into the writing process as you begin to 
assemble your final document. As such, the summary should be comprehensive, relevant, and con- 
textually accurate in order to provide support for your argument. 
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CHAPTER 12 a 
Revising + Editing 


he writing process is often seen as a task that has a start and finish. To some degree, this is 

true. Most of the time we do not have the luxury of writing and polishing our work for an 

endless amount of time. In technical writing, deadlines are almost always present and they 
are usually tighter than we had like. Timelines are often dictated by others, and going at our own 
pace is not something you can count on. 


However, thinking of writing as a one-and-done event also has its drawbacks. It leads to thinking 
that the project has to be perfect the first time (which is unattainable), and that once we are done, 
we never have to think about it again (often untrue). If those statements are both true, then we have 
to adjust our mindset about revision and iteration. 


ITERATION 


Iteration is the key to successful communication. We are often compelled, either by those around us 
or by ourselves, to produce something that is perfect before we share it. However, creating content 
in a silo, and holding onto it until you feel it is ready for the world can be detrimental to the quality 
of your final deliverable. 


To iterate on something, or to continuously make revisions and adjustments to something once it 
is gone out to others means that you are creating something that is truly reader centered. Creating 
feedback loops and making revisions based on feedback is one of the best ways to improve a piece 
of documentation. By starting with a piece that is simply “good enough” to show others—ideally 


oy 


proxies for your intended audience—and then soliciting feedback, you ensure that you provide your 
final audience with a document that serves their needs. No guessing required. 


This process is an extension of the audience analysis stage. Starting with a general understanding of 
your audience will get you close with your first version, and the feedback from your audience will 
help you finalize and refine your document. 


EDITING VERSUS REVISING 


Editing and revising are often used interchangeably. However, they are different actions, and they 
perform different functions in the document creation process. 


The editing process refers to cleaning up your document and making technical and grammatical changes. 
Editing is done to create clarity and correct mistakes and should be done after the revision process. Ed- 
iting can be done by the author or by someone else, though it is usually the responsibility of the author. 


The revising process refers to making changes based on external feedback and additional personal 
review that seeks to add depth or understanding to a document. The revision stage is also where you 
made changes to ensure compliance with the original purpose or intention. 
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THE REVISION PROCESS 


The revision process steps back and focuses on macro-level changes. These changes can be minor or 
sweeping and often alter the context or intention of the document. Macro-level changes add depth of 
understanding and are a final check before moving into editing or finalizing the document for use. 


Revising a document happens best by taking a few days away from it and coming back with fresh 
eyes, passing it to others for feedback, or a combination of both. You should leave enough time be- 
tween writing your first draft and the final draft deadline so that there is time to gather feedback and 
take a fresh look at your document. 


The following steps can guide the revision process for any document or presentation: 


iF 


Compile and write the first draft. With your audience analysis and research done, piece to- 
gether your first draft into the most complete version possible. The more complete the draft is, 
the easier the editing and revising processes will be. 

Pass to others and encourage honest feedback. Whether you choose to have some form of 
peer review or others outside your organization review your document, it is critical that you get 
outside input before you finalize your project. 

Review the document again after a few days away from it. Build time into your schedule to 
allow your document to sit for a few days after you have completed the initial draft. When you 
have been working on something intensely, it is easy to lose sight of the big picture and get 
caught up in the details. While your document is being reviewed by others, take the time to 
review it yourself as well once you have had a chance to take a break from it. 

Process all feedback before making any changes. It may be tempting to start revising as soon 
as you get feedback from a reviewer, but if you have sent it out to multiple people, be sure to wait 
until you have all feedback before you make any changes. Some of the feedback may conflict, 
and it is important that you process all of the feedback and give yourself time to decide what to 
revise and what to leave as is. 

Understand how each change you make will affect the rest of the document. Making one 
change in your document often creates a domino effect of other changes that need to happen 
throughout the rest of the document to ensure consistency and alignment. Take the time to 
ensure that any change you make is accounted for in the entirety of your document. 

Make the necessary revisions. Once you have processed all feedback and taken the time to 
understand how your changes could affect the rest of your document, it is time to make the 
revisions. 

Pass to others again for another round of feedback. This is a critical part of the process that 
often gets left out. Once you have made revisions, you should solicit another round of feedback 
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from the original people who provided it for you. Make sure that your document reads smooth- 
ly and that the changes are aligned throughout the document. 

8. Polish and complete. Once all of the revisions are done, it is time to undertake the editing pro- 
cess to polish and complete your document for its final delivery. 


EDITING PROCESS 


The editing process is intently focused on the micro-level changes necessary to ensure a document is 
grammatically and technically correct as well as clear and free of blatant errors. Micro-level changes 
refer to going through the document line by line and editing for grammar and clarity as needed. 


Your goal with the editing process is to ensure your document is clear and concise. Use the tools 
available to you, of which there are many, to check grammar, sentence structure, and spelling. An- 
other tool available to you, and often overlooked, is reading your content aloud to yourself. This 
makes it much easier to spot errors and issues with grammar. It can even help better understand 
where to put paragraph breaks or to update the document's organization. 


At a minimum, by the end of the editing process, you should have no doubt that anyone in your 
intended audience will understand your information. If you can succinctly say it in one page, think 
about what it would look like in one paragraph or in one sentence. If you can get that far, then your 
document is ready to deliver to your audience. 


BEST PRACTICES FOR EDITING, REVISING, AND REVIEW 


While the writing process can be challenging, it is often the processes that come after the initial 
writing that be the most overwhelming. Having others review your document and then undertaking 
the editing and revising processes can seem even harder than writing the first draft. However, the 
following best practices can help ease some of those potential challenges: 


¢ Only solicit feedback from those who will provide honest commentary. To get the most out 
of the review process and to ensure that you use your time effectively, only solicit reviews from 
those you know will provide helpful and actionable feedback. 

* Do not take feedback personally. If you solicit feedback from others, it is critical that you take 
it in stride and that the reviewers are trying to help you make the document as effective as pos- 
sible. Do not let feedback discourage you or create unnecessary frustration. 
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¢ Do not wait until the last minute. The longer you wait to get feedback, the more rushed the 
editing and revising processes will be. Be sure to plan accordingly to allow enough time for re- 
viewing, editing, and revising without having to rush any part of the process. 

¢ Use track changes and comments to document updates. Using the track changes and com- 
ments features allows multiple people to review or edit the same document and you can see all 
of the suggested changes without having to accept them all. 

¢ Practice version control. When editing and revising documents, it is critical that you keep 
older versions of your document just in case you need to revert back or reference what you had 
previously. Do not discard old versions of your document or completely overwrite them. 

e Remember to include images, tables, and graphs in a first draft. The more complete your 
drafts are, the more valuable the feedback will be. Even if it seems trivial, you should do as 
much as you can before soliciting feedback so that anyone reviewing your document gets the 
full context of the content. 

¢ Move from macro level to micro level. The editing process should take place just before you are 
ready to finalize your document. Do not worry about editing until you have revised and have 
the content where you want it to be. If you do micro-level edits first, you will likely end up doing 
edits several times. 
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CHAPTER 13 
Communicating in the Workplace 


rofessionalism is a key concept in all principles of business communication and is the pillar 

for any form of business communication, including text messages and emails. This chapter 

builds upon the concepts in the previous chapters and applies them directly to business com- 
munication types and use cases. 


Whether you are in a position where you need to communicate regularly (hint: any position and 
job available) or you are searching for a job, communicating clearly and with a professional tone is 
paramount to making a good impression and performing well. 


A point worth making: today’s world is hyperconnected; as such, your digital persona is often your 
first impression. You should put as much care into digital communication as you would into prepar- 
ing for a face-to-face conversation in the workplace or a business setting. 


BUSINESS WRITING 


There are two core forms of business writing: formal and informal. Formal communication generally 
refers to anything that will be seen by larger groups or in some way represents the organization or 
your department as a whole. 


Informal communication generally refers to any type of day-to-day communication or communica- 
tion intended for smaller, internal groups. Often, informal communication is where professionalism 
is most lacking because it is not seen as a necessity. However, any time you communicate with some- 
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one, either internally or externally, it is a reflection of you and your organization. Regardless of the 
type of communication, you should always strive to maintain a level of professionalism. 


FORMAL COMMUNICATION 


Formal communication is any communication that will be used by a large group of people or is a 
representation of your organization or department as a whole. There are many types of formal com- 
munication, the most frequently used in today’s workplace are memos and reports. Though this is 
certain to change over the years, the core principles for these types of communication hold true for 
any type of formal workplace communication. 


Memos are not generally called that in today’s workplace; they often show up as notices or an- 
nouncements sent via email. Conceptually, however, those emails use the same tactics as you would 
in what is traditionally been referred to as a memo. 


Understanding how to position your formal communication piece starts with your audience and 
purpose. An error often seen in the workplace is that the wrong form of communication is used 
given the audience and purpose. Even in the workplace, you should start by analyzing your audience 
and getting clear on your purpose to avoid confusion or unnecessary work. 


MEMOS 


Memos are often used for internal communication and everyday correspondence, generally in cases 
where employees may not have regular access to email. Prior to email, memos were the main form 
of internal communication for organization. 


Although they are not used as often in today’s workplace, they still have specific use cases where they 
provide instructions, relay information, or make requests. Memos also have legal implications since 
they are often a way to create a paper trail for making decisions or regulation compliance. 


Though memos can vary in their content, they do contain specific elements that make them a memo: 


e Company Name 
¢ To (who it is for) 
¢ From (who it is from) 
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e Date (date of posting/send) 

¢ Subject (what is the content of the memo) 

¢ Body Text (the critical information that needs to be passed to the audience) 
¢ Enclosures (any secondary, supporting documents) 


Figures 13.1 and 13.2 are workplace memos showing their content and use case as well as their for- 
mat. Memos like this would be posted in a common area as well as sent out via email or delivered 
to desks via printed copy. 


Acme Organization 
Company Memo 


To: All Acme Organization Employees 

From: HR Manager 

Date: February 10, 2019 

Subject: OSHA Committee Meeting Minutes for Quarter One 

Below are the meeting minutes for the OSHA quarterly review meeting. 
8 am—Roll Call, all committee members present 
8:15 am—Review last quarterly meeting’s minutes 
8:30 am—Discuss elevator safety and new signage 


8:45 am—New items brought up for consideration 


9 am—Meeting closed 


If you have questions on the above information, please contact the HR manager. 


Enclosure: List of Attendees 


FIGURE 13.1 MEMO CONTAINING MEETING MINUTES. 
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Total Software Solutions 
Company Memo 


To: Total Software Solutions Weekend Staff 

From: HR Coordinator 

Date: May 12, 2019 

Subject: West Parking Lot Resurfacing—Parking Change 


The west parking lot will be closed Friday starting at Noon for resurfacing. The parking lot will 
reopen at 10 am on Monday. 


While the parking lot is under maintenance, we ask that you park in the east parking lot or the 
overflow parking at the back of the building. 


If special accommodations are necessary, please see the HR coordinator for a temporary main 
lot parking permit. 


We thank you for your cooperation. If you have any further questions or concerns, please reach 
out to the HR coordinator. 


Enclosure: Parking Lot Map 


FIGURE 13.2 MEMO CONTAINING A REQUEST. 


This format is appropriate when you want to emphasize the importance of a piece of information or 
ensure that a critical request is seen by all in a timely manner. 


Note that memos should only contain one subject or request. Never combine requests or informa- 
tion from two or more topics into the same memo. In addition, if the text in the memo requires 
further explanation or supporting materials, they should be noted at the bottom as “Enclosures” so 
that people know to look for the other documents. The other materials should not be included in 
the memo itself. 
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REPORTS 


There are several different kinds of reports that are used in slightly different situations. Reports are 
often used when recommendations or findings are being explained and require a lengthier discus- 
sion than what a memo allows for. 


Analytical reports, the most common type of formal report, seek to answer several core questions: 


1. What do we know about a situation given the information you have been able to collect? 
2. What conclusions can we draw about the situation? 
3. What action should we take or not take based on the information? 


There are three typical types of formal reports: 


¢ Causal analysis—These reports seek to find out what something happens. 

¢ Comparative analysis—These reports compare several options to determine which best suits 
your needs. 

e Feasibility analysis—These reports are created as a way to determine if something is a good 
idea and if it will actually work given specific parameters. 


While reports take various forms depending on the audience and purpose, there are a set of ele- 
ments that all effective reports contain. These elements align with the requirements of all effective 
technical documents: 


¢ A clearly identified purpose or problem to solve 
« An adequate amount of data 

¢ Thoroughly researched and unbiased data 

¢ Fully interpreted data 

¢ Relevant and redundant visual elements 

¢ Valid conclusions and recommendations 


Sometimes, reports can be delivered via printed document or electronically, but they are most often 
accompanied by a verbal explanation of the findings. The verbal explanation may be in a less formal 
setting, but it is critical that the report provides formal and thorough support for your position. 
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INFORMAL COMMUNICATION 


Informal communication is the most common type of business communication and is ubiquitous 
throughout the workplace. From emails to text messages and all forms of instant messaging, infor- 
mal communication has become easier to do within the office as well as on the go. 


Though communication has become easier, it has become increasingly less professional. The ease 
through which we can communicate through our computers and mobile devices gives the impres- 
sion that we are always talking with a friend or family member. This, however, can cause many 
problems within the workplace. 


Miscommunication and poor impressions run rampant when we do not pay attention to the details 
that make our communication professional. From grammar and spelling to appropriate tone and 
style, all must be considered before sending any type of message, no matter how small it may seem. 


For any type of informal communication, it is important the subject matter of the communication 
is also informal. If you need to communicate on a sensitive topic or your message could easily be 
misinterpreted, you should meet in person or use a more formal type of communication method. 


EMAIL 


Email is the most common form of workplace communication and is most susceptible to issues 
that arise from carelessness. Email can address an individual or a group within an organization, no 
matter where they are or what time zone they are in. Emails can be easily forwarded to others who 
may need the information or can be used as a paper trail for decision-making. These benefits are 
also what make them dangerous if not handled properly. 


Sending an email is best for situations where you need to relay a simple, routine message or ask a 
simple question. Too often, email is used for complex discussions in place of meetings or face-to- 
face interactions. There are, however, best practices to use when writing emails that can ensure they 
are still a quick and effective form of communication. 
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Email Best Practices 


¢ Clear and concise subject line 

e One topic or question per email 

¢ Clear action or request for response 

e Time, date, and location options when asking to meet 

¢ Options for taking the discussion out of email for more complex topics 
e Read and respond to emails during set windows throughout the day 

¢ Quick edit for appropriate grammar and spelling 


Following these best practices can ensure that your emails remain an effective form of workplace 
communication and do not become a source of stress or distraction throughout the day. 
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INSTANT + TEXT MESSAGING 


Various programs allow for instant messaging throughout the workplace. Though the programs 
differ in functionality and features, they accomplish the same task: accessible, immediate access to 
a coworker. 


This type of constant and quick access allows for quick responses to questions or concerns and pro- 
vides an alternative to meetings and face-to-face interactions. This is especially useful for organiza- 
tions where people often collaborate across departments, large campuses, or remote offices. 


As with email, the ease of using instant messaging gives way to poor communication habits such as 
responding with images or emojis, poor grammar and spelling, and misguided attempts at humor 
or sarcasm, which rarely land appropriately via written word. 


The best practices for email can be applied to instant messaging as well. It is important that instant 
messaging is also conducted within specific windows; otherwise, it is easy for it to become a distrac- 
tion from daily work. 


Text messaging should be used sparingly for workplace communication unless a specific situation 
warrants it. It should also be kept to a minimum if you are not using a company cell phone. Texting 
is something that most of us do for personal communication, and it is too easy for issues to occur if 
we begin to mix work and personal communication methods. 


Some situations where it may be necessary to text include communicating with coworkers or con- 
tacts at trade shows or conferences, communicating with a coworker who is out of the office for 
work-related matters, or if your boss or coworker has explicitly requested a text message for some 
reason. 


When texting, it is critical that all nonwritten communication (such as emojis) are clear and that 
you still perform a quick edit to ensure proper grammar and spelling. It is also important to make 
sure that autocorrect did not change your intended word choice. 
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CHAPTER 14 o- 
Building Your Application Package 


ommunicating professionally in the workplace is a critical component of being respected 
and trusted. But before you ever communicate within the workplace, you must communi- 
cate with the organization as a prospective employee. 


Job hunting can be both a stressful and exciting time. It can also be confusing; everyone seems to 
have an opinion on how best to approach landing a job. This is not only true when you are looking 
for your first job, but it remains true as you progress in your career and change jobs or organizations. 


The job hunt will look different for everyone, but this section explores some best practices for vari- 
ous stages of the job search and provide actionable items you can execute that will make you more 
likely to find and land the job that you want. 


RESUMES 


This section does not provide instructions on how to format your resume. There are many examples 
and templates online and within word processors that you can use to build your resume. Instead, 
this section provides you with the tools necessary to make your resume stand out from others with 
its content, not its aesthetic. 


e Tell a story. Your resume should tell a story—your story and how you fit into the company’s 
story. Where have you been, where are you going, and why is this the right position and right 
time? Not only address why it is right for you, but also why it is right for them. There has to be a 
perceived mutual benefit to hiring you. After all, the organization had a need, which is why they 
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posted the job opening. You have to appeal to that need, not just your own wants and needs as 
a job seeker. 

Do not provide references. References should never be added to a resume unless the job post- 
ing specifically asks for them. If and when references are needed, the organization will ask you 
for contact information. Checking references is often the last stage of the hiring process and 
sometimes even happens after the offer has been made. 

Use a professional email address. Your first name and last name in some appropriate combi- 
nation work best. 

Be as specific as possible. This is not to be confused with wordy. Do not just say you are detail 
oriented; give a specific example of what you did at your previous job that required you to be 
detailed. As in, what aspect of a job could you not perform well if you were not detail oriented? 
Empty phrases are the most common pitfall of a resume, so anytime you can add specificity you 
should. 

Numbers are your friend. Hiring managers will scan your resume, and numbers stand out 
easily amongst a sea of text. Use numbers to illustrate how much money you saved a company, 
how much you improved “x” variable, and so on. $ and % should be well represented on your 
resume (as long as it is relevant). Providing context to your accomplishments not only helps 
your resume stand out, but it also gives the hiring manager a clear picture of your capabilities. 
Keep design elements to a minimum. Using brightly colored fonts or large typefaces will get 
you noticed, but not in a good way. Avoid using templates that have too many design elements 
or include a space for a headshot. Resumes should be clean, clear, and to the point. 

Replace your objective with a summary. Most resume templates have a space for an objective. 
However, objectives are often either too obvious or they allude to the position simply being a 
stepping stone to something bigger. A personal summary, on the other hand, provides a quick 
snapshot into who you are and how your experiences and interests align with the position and 
organization. 

Keep it short. Unless asked for specifically, your resume should only include the most relevant 
information and should be one page in almost all situations. If you find that your resume is lon- 
ger than one page, examine it to ensure you have only included information that is pertinent to 
the specific job you are applying for. 

Keep it relevant and customized. Although it may seem like a lot of work, all resumes should be 
somewhat customized for the particular position you are applying for. Even if positions are sim- 
ilar, companies often have their own requirements and personalities and it is critical that you in- 
clude content that is hyperrelevant to that company and position. All of the information you need 
to customize your resume is within the job listing itself. Pay close attention to their requirements 
and include only those elements of your resume that correspond to their requirements. Hiring 
managers can tell when your resume is something you have sent to 50 other companies. 
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Following these best practices can ensure that your resume is noticed and that you filter to the top 
of what is likely a large pile of applications waiting to be reviewed. As with other forms of technical 
communication, it is important that your resume is clear and concise and can be skimmed for the 
most essential information. 


COVER LETTERS 


Although not always required for a job application, the cover letter provides a unique method for 
communicating more about yourself to a hiring manager. While a resume should be fact based and 
concise, a cover letter is your opportunity to provide more details about your qualifications and 
about you as a person. Cover letters also provide another place for you to show that you have done 
your research on the company and are not just spamming the same form letter and resume to every 
job posting you find. 


A cover letter is a formal letter, even though it is most often transmitted electronically as an attach- 
ment to an email or as a file upload on an online application. As such, formal letter elements should 
be applied to any cover letter you write. These elements include: 


e A heading with the sender's address 
e Date 

« Salutation 

¢ Body text using paragraph style 

¢ Complimentary closing 


The cover letter is not the email that you send along to a hiring manager with your resume attached, 
unless of course, it has been specified that you do it that way. The email is simply a note to the hiring 
manager that you have enclosed your cover letter and resume. The cover letter should be a separate 
file attachment. 


Some best practices for effective cover letters include: 


e Showcase your writing skills. Edit for proper grammar, spelling, tone, and style. Good com- 
munication skills is often a requirement for job openings, so illustrating that through your cover 
letter will set you apart from others applying for the job. 

¢ Tell a story. As with the resume, the cover letter is a chance to put a personal touch on your 
application without ever having to meet in person. Just make sure that the stories or anecdotes 
are relevant to a requirement of the position. 
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« Use it to explain anomalies on your resume. If you have a gap in employment or little profes- 
sional experience, the cover letter can provide space for you to explain why or provide insight 
into other skills you may have. 

« Treat it as a piece of marketing. At the end of the day, you are trying to market yourself as an 
attractive prospect to the organization. Do not make it a one-sided sales pitch, instead focus on 
why it is the right fit for everyone. 


Following these guidelines can ensure that your cover letter helps your chances of getting hired. The 
cover letter should be a reflection of who you are and what you can bring to the table. Be sure that 
the writing does not get in the way of showcasing your skills. 


NETWORKING 


Knowing someone on the inside of the organization you are applying to will almost always help your 
chances of being hired. The more you can get your name in front of people, the better. To do so, 
you can use social media responsibly to connect with key people at the organization. Follow them 
on Twitter, find them on LinkedIn, and use creativity where needed to get your information out to 
the right people. But remember, networking and connecting should not be a one-way street. Engage 
with the organization by participating in conversations and adding to the discussion in a thoughtful 
way. Do not simply ask for favors or endlessly self-promote. 


Creating a professional profile on platforms such as LinkedIn is a good way to start networking. 
If you do create a professional profile, follow many of the same best practices we discussed for re- 
sumes. Your professional profile may be the first impression a potential employer has of you, so you 
want to make sure you put your best self forward. It just as important, if not more important, than 
the first impression you make at an interview. If you make a poor impression online, you may never 
get to the interview stage. 


INTERVIEW + NEGOTIATION 


The interview and negotiation are elements of the job search that are either over or under empha- 
sized. Although interview and negotiation are important, there are several best practices that you 
can follow that make these processes effective and painless. 
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¢ Pre-Interview. Eighty percent of the work for an interview comes before you step foot in the 


office. Before you go to an interview for a job you really want, you should do the following: 

¢ Research the company and its founders and executives. 

¢ Reach out to an employee and offer to take them to lunch or coffee. 

¢ Geta sense of the company’s current struggles and issues. 

¢ Prepare a thorough document or note that illustrates issues you have identified and how 
you can begin to help address them immediately. 

e During the interview. 

¢ Follow all of the guidelines sent to you prior to the interview. 

¢ Understand the culture and expectations of the company to determine how you should 
dress. 

¢ Arrive 5 to 10 minutes early. 

e As the questions come up that pertain to the issues you identified previously, pause and pull 
out the document you created. Hand it out to anyone present and go through it with them. 

¢ Ask them relevant questions about their job at the company and why they enjoy it. 
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¢ Post-Interview. 
¢ 1 to 2 days after the interview, send a follow-up email thanking them for the opportunity 
and attach the document you prepared for them previously. 
« Ask about a specific timeline for hiring decisions. 
« Give them your contact information and let them know they can reach out anytime with 
questions. 
¢ Be prepared to tell them your salary and benefit requirements. 
e Negotiation preparation. 
« Know your goal and work backward. This is a long game, but you want to make sure you set 
yourself up to succeed. 
¢ Do your market research and understand what the offer might be before it is offered. 
¢ Create a fallback plan. For example, if they cannot raise your salary $5,000 to start with, ask 
for a concrete plan to get you there after 6 to 12 months. 
« Much like with your interview preparations, have a document ready that showcases why 
you feel you cannot possibly take anything less than your requirements. 
¢ The negotiation. 
¢ Donot undercut yourself. Ask for what you want (and what you prepared for), and be firm. 
e Ifthey cannot meet your requests, revert to your fallback plan (if you still really want the 
job). 
¢ Beconfident and speak with authority. Avoid weak verbs or phrases of self-doubt. 
e Ask about the opportunities instead of telling them directly what your requirements are in 
the beginning. 
¢ Be willing to walk away if it is not the right fit. 


With the interview and negotiation processes, it is critical that you do your research ahead of time 
and understand your own expectations and needs. Do not forget that during an interview you are 
also interviewing the company; make sure it is a place that you will be happy with and where you 
feel you will be challenged professionally. 


JUST THE BEGINNING 


The concepts, strategies, and frameworks provided in this book are just scratching the surface of 
technical communication. In practice, the topics covered here can get you well on your way to being 
a more effective and efficient writer and will provide you with the skills necessary to lead teams and 
projects. 
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Though this base knowledge is a critical component of becoming a better writer, the only way to 
truly sharpen your skills is through practice, feedback, and revision. The more often your put these 


tools to use and the more frequently you solicit feedback from others, the more it will become sec- 
ond nature. 


As your skills improve, not only will your technical communication improve; you will see benefits in 


your everyday communication with friends, family, and colleagues, which can strengthen relation- 
ships and make you an invaluable member of any team. 
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APPENDIX 
Checklists and Examples 


DOCUMENT USABILITY 


Document Usability Checklist 


Content 
¢  Isall of the material relevant to the purpose + audience? 
Is the content accurate? 
Does the content match the level of technicality of the audience? 
Is the content clear + concise? 
Are all data sources documented in some form? 


Design + Organization 
¢ Is there a clear structure to the document? 
Is the document easy to skim? 
Are paragraphs + sections digestible in length? 
Is the page inviting + accessible? 
Are there visuals to clarify + support the text? 


Are sentences + paragraphs easily understood the first time through? 
Do the sentences + paragraphs provide context in as few words as possible? 
Are there fluffs or needlessly elevated words? 


8] 


ORGANIZATION + DESIGN BEST PRACTICES 


Organization + Design Checklist 


Organization 
Does the document follow a standard structure of an intro/body/conclusion? 
Have you created a storyboard or outline to organize your document ahead of time? 
Do paragraphs include a topic sentence + supporting information? 
Are paragraphs connected logically and are transitions use throughout? 
Have you considered your audience's expectations for organization? 


Does the document use headings and subheads to guide the reader? 
Are page numbers used consistently? 

Is there enough white space between paragraphs and in the margins? 
Is the spacing + font size consistent? 

Are numbered or unnumbered lists used appropriately? 

Are visuals used to clarify or amplify the text? 

Are visuals labeled appropriately? 

Is text emphasis (bold, italics) used consistently? 


Read the entire original article 

Underline or highlight the most important parts of the original as they pertain to your topic 
Reread the highlighted material 

Piece together the highlighted information into paragraphs 

Rewrite the essential paragraphs you have pieced together in your own words—begin 
relating the information to your topic 

Edit your version of the information so that it is concise and focused on the relevant 
information 

Verify your version against the original to ensure that the general context has not been 
changed or obscured 

Rewrite the edited version to add transitions and ensure it reads clearly 

Document your source in the specified format (MLA, APA, Chicago, AP, etc.) 
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EDITING CHECKLIST 


Editing Checklist 


Sentences + Paragraphs 
Are all sentences complete without being run-ons? 
Is the sentences written in active voice? 
¢ Is there a specific reason that passive voice is used, if present? 
Are modifiers used to modify the appropriate word? 
Are pronouns used in clear reference to a specific noun? 


Punctuation 
« Are commas used appropriately throughout? 
¢ Doall sentences conclude with some form of punctuation? 


Are plurals and contractions written properly? 
e Are brackets or parentheses used appropriately? 


Formatting + Mechanics 
Are abbreviations used correctly and in accordance with the level of technicality of the 
audience? 
Are words capitalized correctly? 
Has spell check or autocorrect corrected words inappropriately? 
Are pages numbered correctly? 
Are sources cited correctly? 
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RESUME CHECKLIST 


Resume Checklist 


Have you reviewed and dissected the job listing? 

Have you used the keywords from the job listing in the resume? 

Do you use numbers to illustrate the context of your experience where appropriate? 
Do you use action verbs and avoid weak word choice such as “I believe” and “T think”? 
Are all experience entries accurate and relevant to the position? 

Did you proofread and edit your resume to ensure it is clean and free of grammatical 
errors? 

Is the resume a single page? If it is more, is all content relevant? 

Has the objective been replaced with a summary of skills and unique value add? 
Have design elements been kept to a minimum? 

Is the font type and size clear and easy to read? 

Have you included all information requested in the job listing? 


Content 
Does the report have a clear purpose and audience? 
Does the content of the report match the level of technicality of the audience? 
Is there enough information in the report for the audience to make a decision? 
Is the information accurate and unbiased? 
Are all sources cited appropriately? 
Are any and all needed supplements included? 
Is there a clear introduction that gives the reader appropriate context to the topic? 
Does the report end with clear recommendation and call-to-action? 


Style + Design 
Are relevant visuals used throughout to clarify or support information? 
Is the writing clear and concise? 
Is the design of the report clean and easily skimmed? 
Are relevant headings and subheadings used throughout? 
Does the report use white space appropriately between paragraphs and with the 
margins? 
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GUIDES + SAMPLES 


SAMPLE OUTLINE 
A Proposal for a New Soccer Stadium 


I. Introduction 

A. Executive summary 

B. Background + history of soccer in the area 

C. Need for a new stadium 

Proposed Solution [Body] 

A. Support needed 
1. List of agencies that need to support the proposed plan 
2. People involved in the planning and construction 

B. Budget 
1. Total Cost 


a) Building materials 
b) Labor 
c) Permits 
2. Fundraising 
a) Events 
b) Volunteers 


C. Location 
1. Proposed land parcels 
2. Permits needed for each location 
Conclusion 
A. Summary of proposal 
B. Call-to-action for raising funds and support 
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IMAGE/GRAPH LABELING SAMPLE 


y 


bi. 


IMAGE 1 STARTING THE DOCUMENT DESIGN PROCESS 


Elements: 
e Appropriate “type” label (image, chart, diagram, table) 


¢« Numbering (starts over for each type) 
¢ Brief description 
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